<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<link rel="StyleSheet" href="css/style.css" type="text/css">
<meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
<title>Atomserver Database Configuration</title>
<meta name="verify-v1" content="sRQSq4VA5FRMhwzFB4U3I9AtgLMtIWTdpVVO6jg1az4=" />
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
var pageTracker = _gat._getTracker("UA-4603527-2");
pageTracker._initData();
pageTracker._trackPageview();
</script>
</head>
<body class="maincontent">
<h1><img src="images/atom-logo.gif" alt="logo">
Atomserver Database Configuration</h1>
<br>
<div class="content"><span style="font-style: italic;">Chris
Berry,
Bryon Jacob.
Updated 05/07/08</span><br>
<br>
For most deployments, you should be able to configure your JDBC
connection by simply specifying a few environmental properties.
&nbsp;The properties that are referenced by the default DataSource
are:<br>
<dl>
<dt><span style="font-weight: bold;">db.driver</span></dt>
<dd>the fully-qualified class name of the JDBC driver to use
(this must be on the classpath of the server)</dd>
<dt><span style="font-weight: bold;">db.url</span></dt>
<dd>the JDBC URL to the database to use</dd>
<dt><span style="font-weight: bold;">db.username</span></dt>
<dd>the username through which to access the database</dd>
<dt><span style="font-weight: bold;">db.password</span></dt>
<dd>the DB password for the given username</dd>
<dt><span style="font-weight: bold;">db.poolsize.max</span></dt>
<dd>the maximum number of active connections that can be
allocated from the connection pool simultaneously (set to a
non-positive integer for no limit)</dd>
</dl>
By default, the bean named <a href="extending_with_spring.html#org.atomserver-dataSource"><span style="font-weight: bold;">org.atomserver-dataSource</span></a>
will be initialized as an instance of <span style="font-weight: bold;">org.apache.commons.dbcp.BasicDataSource</span>,
using the values of the above environment properties to make the
connection to the DB.<br>
<br>
If you need to use a different implementation of <span style="font-weight: bold;">DataSource</span>, or if
you need finer-grained control over the configuration properties, you
can create your own bean to override the default one, as described in <a href="extending_with_spring.html">Extending Atomserver with
Spring</a>. &nbsp;Just make sure to name the bean <a href="extending_with_spring.html#org.atomserver-dataSource"><span style="font-weight: bold;">org.atomserver-dataSource</span></a>
if you want it to be injected into the other Atomserver beans. <br>
</div>
</body></html>